Skip to main content
Version: 5.2.0.0

LDAP Authentication

Defines handling for authenticating Orchestra Runtime users using LDAP.

There are several methods for authenticating against LDAP servers.

LDAP Authentication Parameters​

ParameterDescription
ldap.BaseDnPath to the context where the user is searched. Not required if RequestPattern is set.
ldap.RequestPatternPattern describing the DN of the user. {0} is replaced by the username defined in the Orchestra Runtime User/Password authentication.
ldap.RequestedAttributeName of the attribute to be requested, typically userPassword. If missing along with UserDn, Orchestra attempts to log in directly with the requested user and password.
ldap.SearchFilterFilter executed in the context specified by BaseDn. {0} is replaced by the username. Not required if RequestPattern is set.
ldap.SearchSubtreeIf true, all subtrees under BaseDn are searched using the SearchFilter. Not required if RequestPattern is set.
ldap.StartTLSEnables (true) or disables (false) STARTTLS. If enabled, Orchestra starts with an insecure connection and upgrades to TLS. Requires ldap:// (not ldaps://) and usually port 389.
ldap.URLURL to access the LDAP server. Use ldap:// for plain connections, ldaps:// for TLS encrypted. TLS is incompatible with StartTLS.
ldap.UserDnDistinguished name of the user with which Orchestra authenticates itself on the LDAP server.
ldap.UserPasswordPassword used by Orchestra to authenticate itself on the LDAP server.
ldap.anonymous.groupDefines the LDAP attribute or query, depending on ldap.anonymous.group.mode.
ldap.anonymous.group.modeDefines how ldap.anonymous.group is interpreted:
ATTRIBUTE – Uses the value of the attribute in the user context.
QUERY – Executes a query against the LDAP server to obtain group membership.
ldap.anonymous.mappingDetermines how roles and scenarios from LDAP override local Orchestra settings:
OVERWRITE – Overwrites both roles and scenarios.
ROLES_ONLY – Overwrites only roles.
SCENARIOS_ONLY – Overwrites only scenarios.
PRESERVE – LDAP applies only on first login; afterward, local assignments remain.
ldap.anonymous.modeIf true, any LDAP-authenticated user can work with Orchestra. Requires an Orchestra user defined by ldap.defaultUser, whose rights are used. If false, an Orchestra account must exist for the LDAP user.
ldap.modeDefines the authentication strategy. If set to DEFAULT, mode is determined automatically from parameters; otherwise, explicitly defines the LDAP authentication strategy.